---
title: "New Payment"
method: POST
path: "/api/v2.0/accounts/{accountId}/paymentgroup (COPY)"
---

# New Payment

`POST /api/v2.0/accounts/{accountId}/paymentgroup (COPY)`

## Path parameters

- `version` string, required
- `accountId` string, required

## Headers

- `Authorization` string

## Request body

- object
  - `RAW_BODY` object[], required — List of payment proposal for withdraw
    - `amount` number, double, required — Quantity of currency to withdraw
    - `currency` string, required — Type of funds to withdraw
    - `name` string, required — Drawer's name
    - `taxIdCountry` 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'AUS' | 'AUT' | 'AZE' | 'BEL' | 'BGR' | 'BHR' | 'BIH' | 'BLR' | 'BOL' | 'BRA' | 'CAN' | 'CHE' | 'CHL' | 'CHN' | 'COL' | 'CRI' | 'CUB' | 'CYP' | 'CZE' | 'DEU' | 'DNK' | 'DOM' | 'ECU' | 'ESP' | 'EST' | 'FIN' | 'FLK' | 'FRA' | 'FRO' | 'GBR' | 'GEO' | 'GRC' | 'GTM' | 'GUF' | 'GUY' | 'HKG' | 'HRV' | 'HUN' | 'IDN' | 'IND' | 'IRL' | 'ISL' | 'ISR' | 'ITA' | 'JPN' | 'KAZ' | 'KOR' | 'LTU' | 'LUX' | 'LVA' | 'MCO' | 'MDA' | 'MEX' | 'MKD' | 'MLT' | 'MNE' | 'MUS' | 'MYS' | 'NGA' | 'NLD' | 'NOR' | 'NZL' | 'PAK' | 'PER' | 'PHL' | 'POL' | 'PRT' | 'PRY' | 'ROU' | 'RUS' | 'SLV' | 'SMR' | 'SRB' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'THA' | 'TUR' | 'TWN' | 'UKR' | 'URY' | 'USA' | 'UZB' | 'VEN' | 'ZAF' — Drawer's country
    - `taxId` string, required — Drawer's unique identification based on the requested country
    - `bankAccount` string — Drawer's bank account number
    - `bankBranch` string — Drawer's bank institution in some cases It's called bank agency
    - `bankCode` string — Drawer's bank code
    - `pixKey` string — Drawer's code for receiving by Pix code, only available for Brazil
    - `iban` string — International bank identification
    - `wallet` string — Target crypto wallet
    - `tag` string — Additional for target crypto wallet information. Mostly used in payments with Solana and Stellar for example
    - `blockchain` 'None' | 'Ethereum' | 'BinanceSmartChain' | 'Solana' | 'Stellar' | 'Ripple' | 'Bitcoin' | 'Polygon' | 'Avalanche' | 'Polkadot' | 'Fantom' | 'Cosmos' | 'Terra' | 'Tron' | 'Optimism' | 'Arbitrum' | 'Tezos' | 'Rootstock' | 'Moonbeam' | 'Injective' | 'Sui' | 'Aptos' | 'Celo' | 'Aurora' | 'Cronos' | 'Base' | 'ZkSync' | 'Linea' | 'Zeniq' | 'PolygonZkEVM' | 'Mantle' | 'TON' | 'BinancePay' | 'Gnosis' | 'Chiliz' | 'LightningNetwork' | '' — Which blockchain wallet is targeting for transaction
    - `qrCode` string — Drawer's payment QR Code

## Response `200`

200

- union
  - object
    - `paymentGroupId` string
    - `totalAmount` integer
    - `totalAmountPaymentsCompletedWithSuccess` integer
    - `numberOfPayments` integer
    - `numberOfPaymentsPending` integer
    - `numberOfPaymentsProcessing` integer
    - `numberOfPaymentsCompletedWithSuccess` integer
    - `numberOfPaymentsCompletedWithError` integer
    - `createdAt` string
    - `payments` object[]
      - `paymentId` string
      - `amount` integer
      - `currency` string
      - `name` string
      - `taxIdCountry` integer
      - `taxId` string
      - `cbuCvu` string
  - object
    - `paymentGroupId` string
    - `totalAmount` integer
    - `totalAmountPaymentsCompletedWithSuccess` integer
    - `numberOfPayments` integer
    - `numberOfPaymentsPending` integer
    - `numberOfPaymentsProcessing` integer
    - `numberOfPaymentsCompletedWithSuccess` integer
    - `numberOfPaymentsCompletedWithError` integer
    - `createdAt` string
    - `payments` object[]
      - `paymentId` string
      - `amount` integer
      - `currency` string
      - `name` string
      - `taxIdCountry` integer
      - `taxId` string
      - `alias` string
  - object
    - `paymentGroupId` string
    - `totalAmount` integer
    - `totalAmountPaymentsCompletedWithSuccess` integer
    - `numberOfPayments` integer
    - `numberOfPaymentsPending` integer
    - `numberOfPaymentsProcessing` integer
    - `numberOfPaymentsCompletedWithSuccess` integer
    - `numberOfPaymentsCompletedWithError` integer
    - `createdAt` string
    - `payments` object[]
      - `paymentId` string
      - `amount` integer
      - `currency` string
      - `name` string
      - `taxIdCountry` integer
      - `taxId` string
      - `bankAccount` string
      - `bankBranch` string
      - `bankCode` string
  - object
    - `paymentGroupId` string
    - `totalAmount` integer
    - `totalAmountPaymentsCompletedWithSuccess` integer
    - `numberOfPayments` integer
    - `numberOfPaymentsPending` integer
    - `numberOfPaymentsProcessing` integer
    - `numberOfPaymentsCompletedWithSuccess` integer
    - `numberOfPaymentsCompletedWithError` integer
    - `createdAt` string
    - `payments` object[]
      - `paymentId` string
      - `amount` integer
      - `currency` string
      - `name` string
      - `taxIdCountry` integer
      - `taxId` string
      - `pixKey` string
  - object
    - `paymentGroupId` string
    - `totalAmount` number
    - `totalAmountPaymentsCompletedWithSuccess` integer
    - `numberOfPayments` integer
    - `numberOfPaymentsPending` integer
    - `numberOfPaymentsProcessing` integer
    - `numberOfPaymentsCompletedWithSuccess` integer
    - `numberOfPaymentsCompletedWithError` integer
    - `createdAt` string
    - `payments` object[]
      - `paymentId` string
      - `amount` number
      - `currency` string
      - `name` string
      - `taxIdCountry` integer
      - `taxId` string
      - `wallet` string
      - `tag` unknown
      - `blockchain` string

## Other responses

- `400` — 400
- `500` — 500

---

[API](https://skmtc.net/transfero/apis/authentication.md) · [All operations](https://skmtc.net/transfero/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfero/authentication/revisions/c1cf67f85267/schema)